Inside Macintosh: QuickTime Components /

Chapter 5 - Sequence Grabber Components / Sequence Grabber Components Reference

Sequence Grabber Component Functions / Controlling Sequence Grabber Components

SGStartPreview

The SGStartPreview function instructs the sequence grabber to begin processing data from its channels.

pascal ComponentResult SGStartPreview (SeqGrabComponent s);

s

Specifies the component instance that identifies your connection to the sequence grabber component. You obtain this value from the Component Manager's OpenDefaultComponent or OpenComponent function.

DESCRIPTION

The sequence grabber immediately presents the data to the user in the appropriate format, according to the channel configuration parameters you have specified (see "Working With Channel Characteristics" beginning on page 5-55 for information about configuring channels). Video data is displayed in the destination display region; sound data is played at the specified volume settings.

RESULT CODES

cantDoThatInCurrentMode	-9402	Request invalid in current mode
deviceCantMeetRequest	-9408	Device cannot support grabber

File Manager errors
Memory Manager errors

SEE ALSO

You stop the preview process by calling the SGStop function, which is described on page 5-38.

In preview mode, the sequence grabber does not save any of the data it gathers from its channels. If you want to record the data, use record mode. You start a record operation by calling the SGStartRecord function, which is described in the next section.

Main | Top of Section | What's New | Apple Computer, Inc. | Find It | Feedback | Help